BBS Toolkit/BBS Toolkit.iso/rbbs_pc/alfg_110.zip/ALLFIG.DOC

Text File | 1989-08-07 | 13KB | 480 lines

         ALLFIG  The Global C.DEF file modification program for RBBS-PC

                        By The Friends of THE PCUG BBS

                            RBBS-Net node 8:914/201
                            FidoNet  node 1:106/111

            (C) Copyright 1989 by Richard Couture of THE PCUG BBS.

                              All Rights Reserved.

                                 July 31, 1989

                                 Version  1.10



















  ALLFIG The Global C.DEF file modification program for RBBS-PC        Page 2
  INTRODUCTION









     ALLFIG is written for SysOps, running RBBS-PC, who have multiple
     SUB-BOARDS to manage and maintain.

     At the present time, changes to C.DEF files have to be made with
     either a text editor or by running CONFIG multiple times.

     ALLFIG is a command shell that will run CONFIG multiple times on
     a preselected set of C.DEF files and allow the changing of several
     parameters per pass.

     This Version of ALLFIG will NOT behave over the COMM ports directly,
     however, since it can be run from a BATCH file, arrangements certainly
     can be made to have a branching batch file when the occurance of a
     certain semaphore file is detected, causing ALLFIG to process after
     a SysOp has teminated the connection to his/her BBS.  The /w parameter
     should NEVER be used in a batch file processed this way.

     Allfig has been tested and WILL run over the COMM ports under DOORWAY
     version 2.00 very nicely

     Using <CTRL><BREAK> while ALLFIG is running may cause  your computer
     to hang.

     ALLFIG WILL run in a DesqView background window quite happily.

     I hope that you find this program useful

















  ALLFIG The Global C.DEF file modification program for RBBS-PC        Page 3
  ACKNOWLEDGEMENTS









     I would like to thank Steve Cooper and Norm McIntosh
     for their many hours of coding as well as for their
     patience in producing ALLFIG.

     Without their input there would be no ALLFIG.





































  ALLFIG The Global C.DEF file modification program for RBBS-PC        Page 4
  INSTALLATION



     First, copy ALLFIG.EXE into the sub directory where your
     xxxxxC.DEF files are located or into a sub directory on the path.

     Then, make certain that CONFIG.EXE is in the same sub directory
     or in a sub directory on the path.

     If you are running multiple nodes of RBBS and you have
     different sets of xxxxC.DEF files for each node in separate
     sub directories, then you MUST have a copy of ALLFIG.EXE and
     CONFIG.EXE in each of these sub directories UNLESS you choose
     to put them in a sub directory on the path.

     Next, with a text editor, create a file with any legal filename
     containing the list of xxxxxxC.DEF files that you want ALLFIG
     to work upon.  You may create several different files for different
     purposes.  I have 5 files that I use called ALL, ALL1, ALL2,
     ALL3, and ALL4.  one file for each node of my BBS and one master
     file.  The format for these files is as follows:

[d:\path\]xxxxxxC.DEF
.
.
.
[d:\path\]xxxxxxC.DEF

     Where d:\path\  =  The complete name of your sub directory where
                           the sub board def files will be found.  If you
                           are working out of the default directory,
                           d:\path\ can be omitted.

        xxxxxxC.DEF  =  The names of your sub board def files



i.e.:

E:\bbs\bbs1\TELIXc.def
E:\bbs\bbs1\VENTURAc.def
E:\bbs\bbs1\WINDOWSc.def
e:\bbs\bbs1\WRDPERFC.DEF
E:\bbs\bbs2\80xxxc.def
E:\BBS\bbs2\ABLEDC.DEF
e:\bbs\bbs2\acadc.def
E:\BBS\bbs2\aic.def




  ALLFIG The Global C.DEF file modification program for RBBS-PC        Page 5
  COMMAND LINE USAGE



     ALLFIG is relatively simple to use.  The command line format is:

               ALLFIG ascii.txt parm1 [parm2 ... parmN] [/w]




WHERE:    ALLFIG        = This program name

          ascii.txt     = The name of an ASCII text file that contains a list
                          (one per line) of the complete file names (and
                          paths) of the RBBS .DEF files to alter

          parm1 - parmN = Strings to give to config.exe.  parm1 is mandatory.
                          (The special string:  \n = <ENTER>)
                          (The special string:  " " = <SPACE>)




EXAMPLE_1:  ALLFIG all.lst 1 richard

          This command line will cause ALLFIG to read the ascii text file:
          ALL.LST.  For each file name found in ALL.LST, ALLFIG will call
          CONFIG.EXE and pass this string:

                <PgDn>1<ENTER>richard<ENTER><End>Y<ENTER>



EXAMPLE_2:  ALLFIG ALL1 31 N C " " D " " \n

          This command line will cause ALLFIG to read the ascii text file:
          ALL1.  For each file name found in ALL1, ALLFIG will call
          CONFIG.EXE and pass this string:

  <PgDn>31<ENTER>N<ENTER>C<ENTER> <ENTER>D<ENTER> <ENTER><ENTER><End>Y<ENTER>











  ALLFIG The Global C.DEF file modification program for RBBS-PC        Page 6
  COMMAND LINE USAGE





EXAMPLE_3:   ALLFIG ALL3.TXT 86 E:\BASE /w

          This command line will cause ALLFIG to read the ascii text file:
          ALL3.TXT.  For each file name found in ALL3.TXT, ALLFIG will call
          CONFIG.EXE and pass this string:

                          <PgDn>86<ENTER>E:\BASE<ENTER>

          And then wait for input from the KEYBOARD.

          Whenever the \w parameter is used:
          The USER must enter <END><Y><ENTER> in order for ALLFIG to
          resume and bring up the next xxxxxxC.DEF to be modified.  If
          ALL3.TXT looks like:

E:\bbs\bbs1\TELIXc.def
E:\bbs\bbs1\VENTURAc.def
E:\bbs\bbs1\WINDOWSc.def
e:\bbs\bbs1\WRDPERFC.DEF
E:\bbs\bbs2\80xxxc.def
E:\BBS\bbs2\ABLEDC.DEF
e:\bbs\bbs2\acadc.def
E:\BBS\bbs2\aic.def

     Then the xxxxxxC.DEF files will be processed in REVERSE order.
     E:\BBS\BBS2\AIC.DEF will be processed first and E:\BBS\BBS1\TELIXC.DEF
     will be processed last.



















  ALLFIG The Global C.DEF file modification program for RBBS-PC        Page 7
  COMMAND LINE USAGE



     Copyright (C) 1989 by Richard Couture of THE PCUG BBS.
     ALL RIGHTS RESERVED.  COMMERCIAL DISTRIBUTION AND/OR USE PROHIBITED
     WITHOUT WRITTEN PERMISSION FROM Richard Couture of THE PCUG BBS.

     Non-Commercial distribution and/or use is permitted under the
     following terms:

          1.   You may copy and distribute copies of ALLFIG executable code
               as you receive it, in any medium, provided that you do so in
               a lawful, friendly manner and that you conspicuously and
               appropriately publish on each copy of each file that is a
               part of the distribution package a valid copyright notice:

                  "Copyright (C) 1989 Richard Couture of THE PCUG BBS.
                  Any copies that you distribute must be distributed
                  free of charge to the recipient of the copy.  ALLFIG
                  may not be sold and you may not rent or lease it to
                  any other person."

          2.   You must keep this License Agreement intact and give any
               other recipients of the ALLFIG program a copy of this License
               Agreement along with the program.

          3.   You must distribute ALLFIG in unmodified form.  You may not
               add an advertisement for your Bulletin Board System, User
               Group, or anything else either as a file in the distribution
               packet or as a header in any archive.  You may not add,
               modify or delete any of the files in the ALLFIG distribution
               archive.

          4.   ALLFIG must be distributed for free. You may not charge a
               distribution fee for the physical act of transferring a copy
               of this program.  You may not place this program in any file
               area of a Bulletin Board System where a fee is required for
               download.

          5.   ALLFIG may not be distributed in any way as part of a package
               that is part of a sales transaction whether that package be
               other software or hardware, such as a modem, CD-ROM, Hard
               Drive, or any software collections.

          6.   You may not modify your copy or copies of ALLFIG or any
               portion of it and you can not copy and distribute any
               modifications.




  ALLFIG The Global C.DEF file modification program for RBBS-PC        Page 8
  ALLFIG LICENSING AND DISTRIBUTION AGREEMENT




          7.   You may not copy, sublicense, distribute or transfer ALLFIG
               except as expressly provided under this License Agreement.
               Any attempt otherwise to copy, sublicense, distribute or
               transfer ALLFIG is void and your rights to use the program
               under this License agreement shall be automatically
               terminated.

          8.   You may not incorporate parts of ALLFIG into other programs
               without the written permission of Richard Couture of
               THE PCUG BBS.  Permission may or may not be granted based upon
               a determination of your intended use.

          9.   For the purposes of this document, "COMMERCIAL USE" is
               defined as concurrent operation of the software on three or
               more computers or data lines owned by the same for-profit
               organization.  Any organization may operate this software
               under the terms of this Non-Commercial Agreement if
               operation is limited to two or less computers or data lines.

          10.  You may use the software only after understanding and
               agreeing upon the above terms.


     NO WARRANTY

     ALLFIG IS LICENSED FREE OF CHARGE AND THERE IS ABSOLUTELY NO
     WARRANTY.  RICHARD COUTURE, THE PCUG BBS AND ANY OTHER PERSONS
     THAT MAY BE INVOLVED IN THE DISTRIBUTION OF ALLFIG PROVIDE ALLFIG
     "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED,
     INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
     MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.

     THIS PROGRAM IS GUARANTEED TO DO ABSOLUTELY NOTHING.  USE IT AT
     YOUR OWN RISK.  NEITHER RICHARD COUTURE, THE PCUG BBS NOR ANY OTHER
     PERSON INVOLVED IN IT'S DISTRIBUTION IS RESPONSIBLE IN ANY WAY, FOR
     ANY DAMAGES RESULTING FROM ITS USE OR MISUSE, DIRECTLY OR INDIRECTLY.

     THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF ALLFIG IS
     ENTIRELY WITH YOU.  SHOULD ALLFIG PROVE DEFECTIVE, YOU ASSUME THE
     COST OF ALL NECESSARY SERVICING, REPAIR OR OTHER DAMAGES TO YOUR
     EQUIPMENT, SOFTWARE, OR OTHER PROPERTY.






  ALLFIG The Global C.DEF file modification program for RBBS-PC        Page 9
  ALLFIG LICENSING AND DISTRIBUTION AGREEMENT







     NEITHER RICHARD COUTURE OR THE PCUG BBS ARE RESPONSIBLE TO YOU FOR
     DAMAGES, INCLUDING BUT NOT LIMITED TO, ANY LOST PROFITS, LOST MONIES,
     OR OTHER SPECIAL, GENERAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
     OUT OF THE USE OR INABILITY TO USE (INCLUDING BUT NOT LIMITED TO LOSS
     OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY THIRD
     PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS)
     OR ANY OTHER LOSS EVEN IF YOU HAVE BEEN ADVISED OF THE POSSIBILITY OF
     SUCH DAMAGES, OR FOR ANY CLAIM BY ANY OTHER PARTY.

       TECHNICAL SUPPORT

       Since ALLFIG is provided free of charge, there is no guarantee of
       technical support.  However, you may contact me by RBBS-NET mail
       or Fidonet mail at the address listed on the cover sheet of this
       documentation.




























**** END DOCUMENTATION for ALLFIG ****